fix: show license purchase guidance when free credits run out by ivanmilevtues · Pull Request #151 · CodeBoarding/CodeBoarding-action

ivanmilevtues · 2026-10-17T12:41:38Z

Preserve Core's quota recovery message instead of replacing it with generic provider-billing advice. Continue using the existing exit code 3 and existing failure reporting for sync/review.

For an exhausted CodeBoarding allowance, Core says:

CodeBoarding quota is exhausted. Buy a CodeBoarding license at https://codeboarding.org/pricing, or wait for your weekly reset.

Capture and forward stderr separately so successful stdout JSON is unchanged. Provider quota guidance remains provider-specific. No new exit code, credential-tier plumbing, workflow changes, or additional summary script.

Quota-exhausted message

The run remains failed, but the review comment and sync summary explain that the CodeBoarding quota is exhausted and link to purchasing a license, with waiting for the weekly reset as the alternative.

Local preview, not a live GitHub run: the real SDK received a mocked Lambda HTTP 402 response, Core produced the message and exit code 3, and the Action captured its failure_reason. The review text comes from action.yml; the sync summary was generated by scripts/action/sync-summary.sh. Both were rendered using GitHub’s Markdown API. The full trace remains in the run logs; the comment and summary contain only the recovery guidance.

Actual GitHub comment rendering

Screenshot of the example comment on this PR, captured from GitHub itself. The disclaimer identifies it as a preview rather than a real failed run.

Validation: all 257 Action tests passed, including subprocess recovery-message preservation and stdout/stderr separation. Black and diff checks passed. Cross-repository mocked HTTP checks verified the real SDK → Core CLI subprocess → Action failure_reason for hosted 402 and provider 429 insufficient_quota.

Release dependency: this PR is ready for review. Before shipping, release Core #648, then bump codeboarding== in action.yml and the matching engine version in scripts/action/supported-providers.json. The current 0.15.1 pin remains unchanged. An Action release must update the moving v1 tag.

Both branches are fix/free-credits-message. No AWS changes are required.

codeboarding-review · 2026-10-17T12:41:50Z

CodeBoarding review

Status: 1 changed component

See the full change in CodeBoarding.

graph LR
    n_Action_Workflow_Scripts["Action Workflow Scripts"]
    classDef added fill:#1f883d,stroke:#0b5d23,color:#ffffff;
    classDef modified fill:#bf8700,stroke:#7d4e00,color:#ffffff;
    classDef deleted fill:#cf222e,stroke:#82071e,color:#ffffff,stroke-dasharray:5 3;
    class n_Action_Workflow_Scripts modified;

_{download artifacts · run 39244159507}

Reuse exit code 3 and existing failure reporting instead of adding a separate code, tier handling, and summary script. Amp-Thread-ID: https://ampcode.com/threads/T-01a153a0-19e7-744b-823a-cde0fc719d16 Co-authored-by: Amp <amp@ampcode.com>

chatgpt-codex-connector · 2026-10-19T12:31:12Z

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review	Status	Commit	Review trigger
📝 Code Review	✅ Completed 2026-10-19T12:37:27.274401Z	`1ce08b7`	Draft marked ready

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

ivanmilevtues · 2026-10-19T12:31:31Z

Clarification: this PR is already ready for review, not a draft. The earlier draft wording was stale.

The implementation is addressed: the Action preserves Core’s quota recovery message using the existing exit code 3. The remaining dependency is release sequencing, not an unfinished error-handling change.

The Action currently installs codeboarding==0.15.1. That version does not contain Core #648’s new CodeBoarding purchase/reset guidance, so publishing this Action against that pin would still show the older Core message. Core #648 needs to be merged and released first; then action.yml and scripts/action/supported-providers.json must both be updated to the actual released version before shipping the Action. We have not guessed a future version or published a release as part of this fix.

This does not block reviewing the PR now. It blocks shipping the complete user-visible fix until the engine pin is updated.

ivanmilevtues · 2026-10-19T13:17:18Z

CodeBoarding review · failed

CodeBoarding quota is exhausted. Buy a CodeBoarding license at https://codeboarding.org/pricing, or wait for your weekly reset.

See the workflow logs.

_{Example of the quota-failure comment for this PR’s screenshot. This is a preview, not a report that this PR’s workflow exhausted its quota.}

Svilen-Stefanov

Looks good. Main thing: this shouldn't merge or at least shouldn't release before the codeboarding== pin bump is in. Couple of smaller nits below.

Svilen-Stefanov · 2026-10-19T14:13:50Z

    stdout = "".join(stdout_lines)
    if return_code != 0:
        reason = ENGINE_REFUSALS.get(return_code)
+        if return_code == 3:


Why only exit 3? Exit 2 has the same issue imo: Core's own-key message names the key tail (Verify the key ending in ...) and the hosted one mentions id-token: write, and both get replaced by the generic "Check the key's secret". Could we drop the == 3 and prefer Core's line for any code in ENGINE_REFUSALS, keeping the dict only as fallback? Would also get rid of the magic 3 here :D

Svilen-Stefanov · 2026-10-19T14:13:50Z

+            # Keep Core's quota-specific recovery guidance instead of replacing it with provider billing advice.
+            for line in reversed(stderr_lines):
+                if "CodeBoarding: " in line:
+                    reason = line.partition("CodeBoarding: ")[2].strip()


With the current 0.15.1 pin, Core prints CodeBoarding: the LLM provider's token or credit quota is exhausted. and the "Add credits ..." part on the next line without the prefix, so this would pick up only the first half, lowercase. So I think we should hold the merge until the pin bump (and supported-providers.json) lands here, right?

Svilen-Stefanov · 2026-10-19T14:13:50Z

+        if return_code == 3:
+            # Keep Core's quota-specific recovery guidance instead of replacing it with provider billing advice.
+            for line in reversed(stderr_lines):
+                if "CodeBoarding: " in line:


nit: "CodeBoarding: " is now a contract with Core's main.py. A named constant with a pointer to codeboarding_cli/main.py would help. Also, since we take the last match, any later stderr line that happens to contain it (shutdown or telemetry noise) would win. Probably fine today, just something to keep in mind.

Svilen-Stefanov · 2026-10-19T14:13:50Z


+    def test_quota_failure_preserves_cores_recovery_message(self) -> None:
+        messages = (
+            "Your free CodeBoarding quota is exhausted. Buy a CodeBoarding license at "


nit: Core no longer says "Your free" since c64094b1 (CodeBoarding quota is exhausted. ...). Can we use the exact string Core emits so the fixture doesn't drift? Same for the PR description.

Svilen-Stefanov · 2026-10-19T14:13:50Z

  with an error annotation saying which, and in review mode the failure comment says it too.
  No partial analysis is published.

+When your free CodeBoarding quota is exhausted, the failure reason links to


nit: same "free" wording here, Core's README dropped it. Fine either way, just keeping the two consistent.

fix: link exhausted free credits to license purchase

f4da912

ivanmilevtues force-pushed the fix/free-credits-message branch from c786341 to f4da912 Compare October 17, 2026 12:42

ivanmilevtues mentioned this pull request Oct 17, 2026

fix: explain exhausted quota and preserve diagnostics CodeBoarding/CodeBoarding#648

Open

ivanmilevtues self-assigned this Oct 17, 2026

ivanmilevtues and others added 2 commits October 17, 2026 15:41

fix: consume the free-credit exit code without an error report file

955b242

ivanmilevtues marked this pull request as ready for review October 19, 2026 12:31

Svilen-Stefanov reviewed Oct 19, 2026

View reviewed changes

Navigation Menu

Repository navigation

fix: show license purchase guidance when free credits run out - #151

fix: show license purchase guidance when free credits run out#151
ivanmilevtues wants to merge 3 commits into
mainfrom
fix/free-credits-message

ivanmilevtues commented Oct 17, 2026 •

edited

Loading

Uh oh!

codeboarding-review Bot commented Oct 17, 2026 •

edited

Loading

Uh oh!

chatgpt-codex-connector Bot commented Oct 19, 2026 •

edited

Loading

Uh oh!

ivanmilevtues commented Oct 19, 2026

Uh oh!

ivanmilevtues commented Oct 19, 2026

Uh oh!

Svilen-Stefanov left a comment

Uh oh!

Svilen-Stefanov Oct 19, 2026

Uh oh!

Svilen-Stefanov Oct 19, 2026

Uh oh!

Svilen-Stefanov Oct 19, 2026

Uh oh!

Svilen-Stefanov Oct 19, 2026

Uh oh!

Svilen-Stefanov Oct 19, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

ivanmilevtues commented Oct 17, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Quota-exhausted message

Actual GitHub comment rendering

Uh oh!

codeboarding-review Bot commented Oct 17, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

CodeBoarding review

Uh oh!

chatgpt-codex-connector Bot commented Oct 19, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codex Review Summary

Uh oh!

ivanmilevtues commented Oct 19, 2026

Uh oh!

ivanmilevtues commented Oct 19, 2026

CodeBoarding review · failed

Uh oh!

Svilen-Stefanov left a comment

Choose a reason for hiding this comment

Uh oh!

Svilen-Stefanov Oct 19, 2026

Choose a reason for hiding this comment

Uh oh!

Svilen-Stefanov Oct 19, 2026

Choose a reason for hiding this comment

Uh oh!

Svilen-Stefanov Oct 19, 2026

Choose a reason for hiding this comment

Uh oh!

Svilen-Stefanov Oct 19, 2026

Choose a reason for hiding this comment

Uh oh!

Svilen-Stefanov Oct 19, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

ivanmilevtues commented Oct 17, 2026 •

edited

Loading

codeboarding-review Bot commented Oct 17, 2026 •

edited

Loading

chatgpt-codex-connector Bot commented Oct 19, 2026 •

edited

Loading